trends_log

Чтение трендов для указанных переменных в заданном интервале времени в формате последовательных записей

Параметры запроса

• pult_apikey (string): API-ключ.
• time1 (uint64): Начало интервала, timestamp c миллисекундами.
• time2 (uint64): Конец интервала, timestamp c миллисекундами.
• vars (string[]): Массив глобальных имен переменных, для которых запрашиваются записи, например: ["P1_N1_var1","P1_N1_var2","P1_N1_var3"].

Возвращаемые значения

• Объект со следующей структурой:

    {
        "time1": <начало интервала>,
        "time2": <максимальное значение `time` среди всех записей всех переменных>,
        "data": [
            [<записи по тренду для переменной_1>],
            [<записи по тренду для переменной_2>],
            ...
            [<записи по тренду для переменной_N>]
        ],
        "total": <полное кол-во записей всех запрошенных переменных в интервале от time1 до time2>
    }
  

  Запись по тренду представляет собой массив со следующими полями:

    [<time>,<value>,<error>]
  

  • time (uint64): время изменения переменной (смещение в мс от time1)
  • value (double): значение переменной в момент time
  • error (int16): код ошибки в момент time (если есть)

Особенности

• Для минимизации трафика запрос и ответ определен в формате массивов
• Первые возвращаемые записи всегда ищутся ближайшие к time1, но имеющие time < time1. Значение этих записей показывает значение переменных на момент time1.
• Возвращаемое значение total показывает ПОЛНОЕ (а не возвращенное) количество всех записей в запрашиваемом диапазоне. Если total > возвращенное количество записей, значит возвращены не все записи, т.к. количество записей по отдельным переменным в запрошенном интервале превышает параметр max_records (настройки сервиса trends). В таком случае выполните дополнительный запрос, указав в качестве time1 время последней возвращенной записи (возвращенное значение time2).

Пример

• Пример WS-запроса:

    {
        "jsonrpc":"2.0",
        "id":1,
        "method":"trends_log",
        "params":{
            "pult_apikey":"31269DCE4F983A31FBE8B88DF67CDAE2",
            "time1":1747148123000,
            "time2":1747148133000,
            "vars":["P6_N6_temp_supply","P6_N6_temp_outdoor"],
        }
    }
  

• Пример WS-ответа:

    {
        "jsonrpc":"2.0",
        "id":1,
        "result":{
            "time1": 1747148123000,
            "time2": 1747148133000,
            "total": 16,
            "data": [
                [
                    [-448, 13.7],
                    [1976, 13.66],
                    [1044, 13.62],
                    ...
                ],
                [
                    [-1487, 12.87],
                    [3015, 12.88],
                    [1044, 12.87],
                    ...
                ]
            ]
        }
    }
  

• Пример HTTP-запроса:

  https://webscada.ru/api/trends_log?pult_apikey=31269DCE4F983A31FBE8B88DF67CDAE2&@vars=[%22P6_N6_temp_supply%22,%22P6_N6_temp_outdoor%22]&time1=1747148123000&time2=1747148133000